home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-adie-spci-00.txt < prev    next >
Text File  |  1993-10-12  |  33KB  |  1,371 lines

  1. Internet Draft (SPCI)                              C. Adie
  2. Expires April 1994                    Edinburgh University
  3. Filename draft-adie-spci-00.txt           12 October, 1993
  4.  
  5.  
  6.          SGML-based Personal Contact Information (SPCI)
  7.  
  8.  
  9.  
  10. STATUS OF THIS DOCUMENT
  11.  
  12. This document is an an Internet Draft.  Internet Drafts are
  13. working documents of the Internet Engineering Task Force (IETF),
  14. its Areas and its Working Groups.  (Note that other groups may
  15. also distribute working documents as Internet Drafts.)
  16.  
  17. Internet Drafts are draft documents valid for a maximum of six
  18. months.  Internet Drafts may be updated, replaced, or obsoleted
  19. by other documents at any time.  It is not appropriate to use
  20. Internet Drafts as reference material or to cite them other than
  21. as a "working draft" or as "work in progress".  To learn the
  22. current status of any Internet Draft, please check the 1id-
  23. abstracts.txt listing contained in the Internet Drafts Shadow
  24. Directories on ds.internic.net, nic.nordu.net, ftp.nisc.sri.com,
  25. or munnari.oz.au.
  26.  
  27. SUMMARY
  28.  
  29. This document describes how personal contact information may be
  30. exchanged in a structured format suitable for machine processing.
  31. The SGML-based Personal Contact Information (SPCI) format can be
  32. used to encode personal information of the type which might be
  33. found on a business card, in a form which is also suitable for
  34. human interpretation.  Possible uses of this format include:
  35. exchange of personal information in email messages; encoding
  36. author information within a document; providing information about
  37. a mailing list; as an exchange format for "address book"
  38. databases; and providing contact information for a company.  The
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45. C. Adie                                                    1
  46.  
  47.  
  48. Internet Draft                12 October, 1993 (Expires April
  49. 1994)
  50.  
  51.  
  52.  
  53.  
  54. SPCI information is encoded using SGML, and the specification is
  55. aligned with the SHAVE rules.
  56.  
  57. A MIME body part type is defined for SPCI information.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98. C.Adie             draft-adie-spci-00.txt                  2
  99.  
  100.  
  101. Internet Draft                12 October, 1993 (Expires April
  102. 1994)
  103.  
  104.  
  105.  
  106.  
  107. Table of Contents
  108.  
  109.  
  110. 1. Introduction..........................................4
  111.  
  112. 2. Informal description..................................6
  113.  
  114. 3. SPCI Semantics........................................11
  115.      3.1 SPCI............................................11
  116.      3.2 Person..........................................11
  117.      3.3 EMail...........................................14
  118.      3.4 Location-dependant Contact Information..........15
  119.      3.5 Physical Address................................17
  120.  
  121. 4. MIME Registration.....................................19
  122.  
  123. 5. References............................................20
  124.  
  125. 6. Security Considerations...............................20
  126.  
  127. 7. Acknowlegements.......................................20
  128.  
  129. 8. Contact...............................................21
  130.  
  131. Appendix I - SPCI Document Type Definition...............22
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151. C.Adie             draft-adie-spci-00.txt                  3
  152.  
  153.  
  154. Internet Draft                12 October, 1993 (Expires April
  155. 1994)
  156.  
  157.  
  158.  
  159.  
  160.  
  161. 1. Introduction
  162.  
  163. This document defines the SGML-based Personal Contact Information
  164. (SPCI) format.  The purpose of SPCI is as a standard for
  165. exchanging personal information of the type which might be found
  166. on a business card.  It is envisaged that SPCI information will
  167. find a range of applications - some potential applications are
  168. listed below.
  169.  
  170. . The most common use of SPCI will likely be to provide
  171.   information about the sender of an email message.  SPCI
  172.   information could be supplied in a .signature file,
  173.   automatically appended to mail messages; or it could be sent
  174.   as a separate MIME or X.400 body part.
  175.  
  176. . SPCI could be used within a document (such as this) to
  177.   indicate the author's contact details.
  178.  
  179. . SPCI could be used as an exchange format for "address book"
  180.   databases.
  181.  
  182. . SPCI could be used to convey information about a mailing list,
  183.   rather than about an individual.
  184.  
  185. . SPCI could be used to convey information about how to contact
  186.   a company, rather than an individual.
  187.  
  188. In most cases, it is envisaged that the SPCI information will be
  189. typed in by hand, and will be read both by eye and by machine.
  190.  
  191. SHAVE [Adie 93] defines a set of rules for using SGML to
  192. represent hierarchical attribute/value information in SGML.  This
  193. SPCI specification adheres to those rules by definition.
  194.  
  195. An SGML document type definition (DTD) for SPCI is defined in
  196. this specification.
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. C.Adie             draft-adie-spci-00.txt                  4
  205.  
  206.  
  207. Internet Draft                12 October, 1993 (Expires April
  208. 1994)
  209.  
  210.  
  211.  
  212.  
  213. The remainder of this document is structured as follows.  Chapter
  214. 2 is an informal tutorial description of the SPCI syntax.
  215. Chapter 3 defines the semantics of the SGML elements defined in
  216. the SPCI DTD.  Chapter 4 gives information specific to the MIME
  217. registration of SPCI.  The SPCI DTD itself is given in Appendix
  218. I.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257. C.Adie             draft-adie-spci-00.txt                  5
  258.  
  259.  
  260. Internet Draft                12 October, 1993 (Expires April
  261. 1994)
  262.  
  263.  
  264.  
  265.  
  266.  
  267. 2. Informal description
  268.  
  269. This chapter informally describes the syntax of SPCI.  It does
  270. not assume any prior knowlege of SGML on the reader's part.  The
  271. syntax is described through examples, without distinguishing
  272. between the features of SGML, SHAVE and SPCI.  This chapter is
  273. not definitive.
  274.  
  275. Here is our first example:
  276.  
  277. <spci>
  278.   <person key="Charles Babbage">
  279.     <name>          Charles Babbage
  280.     </name>
  281.     <title>         Assistant Programmer
  282.     </title>
  283.     <org>           Calculating Machines plc
  284.     </org>
  285.     <email>         babbage@calc.co.uk
  286.     </email>
  287.   </person>
  288. </spci>
  289.  
  290. An important SGML concept is the "element" - part of a document
  291. which is delimited by a "start tag" and an "end tag", and which
  292. may contain other elements and plain text.  The main element in
  293. this example has a start tag of <spci> and a corresponding end
  294. tag </spci>.  A program can use these particular tags to identify
  295. where the SPCI information starts and ends.
  296.  
  297. The spci element contains a person element with its own start and
  298. end tags (we'll ignore the key="Charles Babbage" part for now),
  299. which delimit the information about one particular individual.
  300. You can have more than one person element within an spci element.
  301.  
  302. The person element contains name, title, org (for organisation)
  303. and email elements, each of which contains plain text data.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310. C.Adie             draft-adie-spci-00.txt                  6
  311.  
  312.  
  313. Internet Draft                12 October, 1993 (Expires April
  314. 1994)
  315.  
  316.  
  317.  
  318.  
  319. There are other elements which could also go in here, as we'll
  320. see.
  321.  
  322. The tags in the above example have been indented to make the
  323. structure clearer.  You don't have to do this, and in subsequent
  324. examples we often won't bother.  However, note that a tag can't
  325. occur in the middle or at the end of a line - it must occur at
  326. the start (ie before any other non-blank characters).
  327.  
  328. Having to specify the end tag of every element is unnecessarily
  329. verbose - the end of an element such as title can be indicated by
  330. the start tag of the next element.  In fact, we can omit all the
  331. end tags except for the last:
  332.  
  333. <spci>
  334. <person key="Horatio Nelson">
  335. <name>         Horatio, Viscount Nelson
  336. <title>        Vice Admiral of the Red
  337. <org>          His Majesty's Navy
  338. <email>        flag@victory.navy.mil.uk
  339. <email X.400>  /CN=flag/OU=HMS Victory/O=Navy/P=MIL/A= /C=GB
  340. <work>
  341. <phone>        +44 31 234 5678
  342.   <>           +44 826 123456
  343. <motto>        England expects
  344.                that every man this day
  345.                will do his duty.
  346. </spci>
  347.  
  348. Note the two occurrances of the email element above.  The first
  349. contains an RFC822 address.  The second email start tag is
  350. qualified by an "SGML attribute" indicating that the contents are
  351. an X.400 email address.  The key="Horatio Nelson" in the person
  352. tag is an example of another SGML attribute.  This key attribute
  353. provides a convenient key which could be used for searching and
  354. indexing purposes by an address book program, for instance.
  355.  
  356. The motto element shows how the value of a parameter may have
  357. multiple lines.
  358.  
  359.  
  360.  
  361.  
  362.  
  363. C.Adie             draft-adie-spci-00.txt                  7
  364.  
  365.  
  366. Internet Draft                12 October, 1993 (Expires April
  367. 1994)
  368.  
  369.  
  370.  
  371.  
  372. The work element contains a phone element.  The phone element in
  373. this case represents a parameter with two values, which are
  374. separated by an empty tag <>.
  375.  
  376. Here's another example, showing some more elements, including an
  377. experimental element X, which in this case contains the name of
  378. the individual's Personal Assistant:
  379.  
  380. <spci>
  381.  <person key="Olivia Peterson">
  382.   <name>                      Olivia Peterson
  383.   <email>                     op@clip.stormford.edu
  384.   <title>                     Chairman & Chief Executive
  385.   <org>                       CLIP Inc
  386.   <note>                      Out of the office <16th
  387.   <work>
  388.    <phone>                    +1 415 123 4567
  389.    <fax>                      +1 415 987 6543
  390.    <postal>                   456 San Sebastian Avenue, Suite 4629
  391.       <>                      Los Angeles, CA, US
  392.       <>                      94040
  393.    <X type="Personal Assistant">   John Smith
  394.    </X>
  395.   <home>
  396.    <phone>               +1 415 234 5678  <!-- After 7pm -->
  397.    <fax>                      +1 415 765 4321
  398.    <instruct>  Operator - notify fax arrival to 234 5678.
  399.   <mobile>
  400.    <phone>                    +1 123 456 7890
  401. </spci>
  402.  
  403. Comments are delimited by <!-- and -->, and may occur anywhere on
  404. the line (outside of a tag).  To represent the less than
  405. character "<" in the value of a parameter, you use the four-
  406. character string <, and to represent the ampersand "&" you use
  407. &.  No other characters need escaping in SPCI.
  408.  
  409. Here is a highly artificial example, which shows almost all the
  410. tags and almost all the features of the SPCI format.
  411.  
  412.  
  413.  
  414.  
  415.  
  416. C.Adie             draft-adie-spci-00.txt                  8
  417.  
  418.  
  419. Internet Draft                12 October, 1993 (Expires April
  420. 1994)
  421.  
  422.  
  423.  
  424.  
  425. <spci>
  426. <person key="John Jones">
  427.  
  428. <name>         Dr John J. Jones
  429. <title>        Consulting Physicist
  430. <dept>         External contracts department
  431. <org>          High Energy Physics Clearances Inc
  432. <email>        jjj@boson.hepi.com
  433. <email X.400>  /I=J/S=Jones/O=HEPC/P=Fargle/A= /C=US
  434. <note>         Ignore any error messages for the X.400 address
  435. <X.500>        J. Jones, High Energy Physics Clearances Inc, US
  436. <motto>        Let us clear those old, unwanted Feynman
  437.                diagrams out of your office.  Green's functions
  438.                also accepted.
  439.  
  440. <work>
  441. <phone>        +1 123 4567 8901
  442.   <>           +1 123 4567 8902 <!-- Secretary -->
  443. <fax>          +1 123 4567 8955
  444.   <>           +1 123 4567 8956
  445. <room>         2309
  446. <building>     Higgs Boson Building
  447. <street>       321 Main St
  448. <city>         Los Angeles
  449. <state>        CA
  450. <postcode>     12345
  451. <country>      USA
  452. <telex>        456789012
  453.  
  454. <home>
  455. <phone>        +44 81 765 4321
  456. <fax>
  457. <faxno>        +44 81 765 4321 <!-- Auto fax/voice switch -->
  458. <faxno>        +44 81 765 6789
  459. <instruct>     Operator - please call 765 4321
  460.                and notify fax arrival
  461. <postal>       12 Leafy Avenue
  462.   <>           Croyden
  463.   <>           LONDON
  464.  
  465.  
  466.  
  467.  
  468.  
  469. C.Adie             draft-adie-spci-00.txt                  9
  470.  
  471.  
  472. Internet Draft                12 October, 1993 (Expires April
  473. 1994)
  474.  
  475.  
  476.  
  477.  
  478.                SW9 9XX
  479.                Great Britain
  480. <courier>
  481. <carrier>      TNT
  482. <phone>        +44 81 765 4321
  483.  
  484. <mobile>
  485. <phone>        +1 898 1234 5678
  486. <pager>
  487. <phone>        +1 123 7654 0987
  488. <instruct>     Ask for page number 3456789
  489. <fax>          +1 898 1234 5000 <!-- In the car -->
  490. </spci>
  491.  
  492. Here is an example of a mailing list represented in SPCI:
  493.  
  494. <spci>
  495. <person key="MMIS list">
  496. <name>              Multimedia Information Systems mailing list
  497. <email list>        mmis@mailbase.ac.uk
  498. <email listownr>    mmis-request@mailbase.ac.uk
  499. <note>              This is the mailing list of the RARE
  500.                     Multimedia Information Systems Task
  501.                     Force.
  502. </spci>
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522. C.Adie             draft-adie-spci-00.txt                 10
  523.  
  524.  
  525. Internet Draft                12 October, 1993 (Expires April
  526. 1994)
  527.  
  528.  
  529.  
  530.  
  531.  
  532. 3. SPCI Semantics
  533.  
  534. The DTD for SPCI is given in Appendix I.  The remainder of this
  535. chapter describes the semantics of the elements defined in the
  536. DTD.  Extracts from the DTD are included in the text for ease of
  537. reference, but in the event of a disagreement between the text
  538. and the DTD in Appendix I, the latter takes priority.
  539.  
  540. The SPCI DTD conforms to the SHAVE rules for DTDs specified in
  541. [Adie 93].  SPCI documents must comply with the SHAVE rules for
  542. document instances also defined therein.
  543.  
  544.  
  545. 3.1 SPCI
  546.  
  547. <!ELEMENT spci - -  (person*) >
  548.  
  549. All SPCI data is enclosed within an spci element, which must have
  550. both a start tag and an end tag.  An SPCI element may contain
  551. zero, one or more person elements.
  552.  
  553. The purpose of the spci element is to delimit SPCI information
  554. within some larger text object such as a mail message or
  555. document.  Note that if SPCI information is sent as a body part
  556. in a MIME message, the MIME message structure could be regarded
  557. as delimiting the SPCI information - however the spci start and
  558. end tags must still be present.
  559.  
  560. There may be more than one spci element within a text object such
  561. as a file or mail message.
  562.  
  563.  
  564. 3.2 Person
  565.  
  566. <!ELEMENT person    - O  (name? & email* & title? & org? &
  567.                          dept? & motto? & note? & X.500? &
  568.                          work? & home? & mobile? & support?
  569.                          & picture?) +(X) >
  570.  
  571.  
  572.  
  573.  
  574.  
  575. C.Adie             draft-adie-spci-00.txt                 11
  576.  
  577.  
  578. Internet Draft                12 October, 1993 (Expires April
  579. 1994)
  580.  
  581.  
  582.  
  583.  
  584. The basic element of SPCI is the person element.  A person
  585. element may contain zero or one of each of the following types of
  586. element, in any order: name, X.500, title, org, dept, motto,
  587. note, work, home, mobile, support, picture.  It may contain any
  588. number of email elements which must all be adjacent.
  589. Experimental X elements may be present anywhere within a person
  590. element and its included elements.
  591.  
  592. The start tag of a person element is mandatory, but the end tag
  593. is not.  The end of a person element is also indicated by a start
  594. tag of the next person, or by an spci end tag.
  595.  
  596. <!ATTLIST person key     CDATA     #REQUIRED>
  597.  
  598. A person element has one (mandatory) SGML attribute, key.  The
  599. key takes a value (enclosed in double quotes) which may be used
  600. for indexing purposes.  The key should be the person's name, but
  601. omitting any prefixes (eg Dr, Professor) and suffixes (eg Jr,
  602. BSc), in order to facilitate sorting and searching.  Note that an
  603. application such as an address book program may modify or ignore
  604. the key it reads from a received document.  One reason for doing
  605. this might be that the application already has an entry in its
  606. database which uses that key.
  607.  
  608. The elements which may be contained in a person element are as
  609. follows:
  610.  
  611. name      Personal name of an individual, with prefixes and
  612.           suffixes if desired.
  613.  
  614. title     The role of the individual within the organisation for
  615.           which s/he works.
  616.  
  617. org       The name of the organisation for which the individual
  618.           works.
  619.  
  620. dept      The department (or other sub-unit) of the organisation
  621.           within which the individual works.
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628. C.Adie             draft-adie-spci-00.txt                 12
  629.  
  630.  
  631. Internet Draft                12 October, 1993 (Expires April
  632. 1994)
  633.  
  634.  
  635.  
  636.  
  637. motto     Descriptive text associated with the individual,
  638.           workgroup or organisation.
  639.  
  640. note      Information which does not fit elsewhere.
  641.  
  642. email     Electronic mail address of the individual.  There may
  643.           be more than one such element, but they must all be
  644.           located together.  See the following section.
  645.  
  646. work      See the section on Location-dependent Contact
  647.           Information below.
  648.  
  649. home      See the section on Location-dependent Contact
  650.           Information below.
  651.  
  652. mobile    See the section on Location-dependent Contact
  653.           Information below.
  654.  
  655. support   A list of the supported MIME types, each type in the
  656.           standard MIME format of the type/subtype, and each such
  657.           pair separated by a list separator <>.  Note that the
  658.           list of MIME types may not be relevant for non-RFC822
  659.           email addresses.
  660.  
  661. X.500     The Directory Name of the individual, in UFN form (see
  662.           RFCxxxx).  If the program which reads the SPCI is
  663.           capable of looking up the Directory, any attributes
  664.           found therein override their SPCI equivalents.
  665.  
  666. picture   A photograph of an individual may make it easier to
  667.           establish contact - eg when meeting someone at an
  668.           airport.  The contents of this element is a URL which
  669.           points to an image of the individual.  The element has
  670.           a mandatory attribute encoding, which contains the MIME
  671.           type and subtype of the image file.  The MIME type will
  672.           usually be "image".
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681. C.Adie             draft-adie-spci-00.txt                 13
  682.  
  683.  
  684. Internet Draft                12 October, 1993 (Expires April
  685. 1994)
  686.  
  687.  
  688.  
  689.  
  690.  
  691. 3.3 EMail
  692.  
  693. <!ELEMENT email     - O  (#PCDATA) >
  694. <!ATTLIST email
  695.      mailsys   (X.400|RFC822)           RFC822
  696.      mailtype  (person|list|listownr)   person
  697. >
  698.  
  699. The email element can occur more than once in a person element.
  700. It contains an electronic mail address of some kind.  The email
  701. element has two SGML attributes, which may both be defaulted.
  702.  
  703. The mailsys SGML attribute can take one of the following values:
  704. X.400, RFC822.  If no value is specified, RFC822 is assumed.  If
  705. the value of mailsys is X.400, the contents of the element is an
  706. X.400 O/R Address, expressed in textual form according to CCITT
  707. recommendation F.4xx.  If the value of mailsys is RFC822, the
  708. contents of the element is an email address as specified in
  709. RFC822.
  710.  
  711. The mailtype attribute can take one of the following values:
  712. person, list, listownr.  If no value is specified, person is
  713. assumed.  The meaning of these values is as follows:
  714.  
  715. person    The email address is the address of an individual.
  716.  
  717. list      The email address is the submission address of a
  718.           mailing list.
  719.  
  720. listownr  The email address is the administration address for a
  721.           mailing list (for subscription requests, address
  722.           changes etc).
  723.  
  724. The latter two are intended for use when the enclosing person
  725. element describes a mailing list rather than an individual.
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734. C.Adie             draft-adie-spci-00.txt                 14
  735.  
  736.  
  737. Internet Draft                12 October, 1993 (Expires April
  738. 1994)
  739.  
  740.  
  741.  
  742.  
  743.  
  744. 3.4 Location-dependant Contact Information
  745.  
  746. An email address is generally independant of the actual physical
  747. location at any particular instant of the individual being
  748. addressed - you could for instance read your email either from
  749. home or at work.  However, this is not generally true of other
  750. forms of communication such as telephone, fax or postal services.
  751. Therefore, within a person element, there can be any combination
  752. of a work element, a home element and a mobile element,
  753. specifying contact information specific to an individual's
  754. location.
  755.  
  756. <!ELEMENT work - O  (phone? & fax? & telex? & ((%physadr;),courier?)?)
  757. >
  758. <!ELEMENT home - O  (phone? & fax? & telex? & ((%physadr;),courier?)?)
  759. >
  760. <!ELEMENT mobile    - O  (phone? & fax? & pager?) >
  761.  
  762. A work element may contain (a list of) phone numbers, (a list of)
  763. fax numbers and associated details, a telex address, and a
  764. physical address suitable for use by a postal service.  Any
  765. combination of these components may be present, in any order.  A
  766. home element may contain the same elements as work..  A mobile
  767. element may contain phone and fax information, and pager details
  768. as well.
  769.  
  770. <!ELEMENT phone     - O  (item+)>
  771.  
  772. The phone element may thus occur in several places.  Its content
  773. is one or more voice phone numbers, conforming to CCITT
  774. recommendation F.103.  Phone numbers are separated by the usual
  775. list separator characters <>, per the SHAVE rules.  The order of
  776. phone numbers in the list is significant - the first number in
  777. the list should be tried first, and if it is engaged or there is
  778. no answer, subsequent numbers should be tried in order.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787. C.Adie             draft-adie-spci-00.txt                 15
  788.  
  789.  
  790. Internet Draft                12 October, 1993 (Expires April
  791. 1994)
  792.  
  793.  
  794.  
  795.  
  796. <!ELEMENT fax   - O (faxno)+ >
  797. <!ELEMENT faxno      O O (#PCDATA,(grain? & instruct? &
  798. faxgate?)) >
  799. <!ELEMENT instruct - O   (#PCDATA) >
  800. <!ELEMENT grain      - O (#PCDATA) >
  801. <!ELEMENT faxgate    - O (#PCDATA) >
  802.  
  803. The fax element is a bit more complex.  It is a list of one or
  804. more faxno elements, each of which consists of #PCDATA
  805. (representing the fax number itself, confirming to CCITT F.103),
  806. followed by any combination of the following three elements:
  807.  
  808. grain     The grain of the fax machine - may have the values
  809.           regular or fine only.
  810.  
  811. instruct  Handling instructions for facsimile operator.
  812.  
  813. faxgate   Internet address of gateway to the facsimile service.
  814.  
  815. The order of fax numbers in the list is significant - the first
  816. number in the list should be tried first, and if it is engaged or
  817. there is no answer, subsequent numbers should be tried in order.
  818.  
  819. <!ELEMENT telex     - O  (#PCDATA)>
  820.  
  821. A telex element contains the telex number to contact.
  822.  
  823. <!ELEMENT pager     - O  (phone, instruct?)>
  824.  
  825. A pager element must contain a phone element with the number to
  826. call to arrange for the individual to be paged.  It may also
  827. contain an instruct element, containing further details of how to
  828. page.
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840. C.Adie             draft-adie-spci-00.txt                 16
  841.  
  842.  
  843. Internet Draft                12 October, 1993 (Expires April
  844. 1994)
  845.  
  846.  
  847.  
  848.  
  849.  
  850. 3.5 Physical Address
  851.  
  852. <!ENTITY % physadr
  853. "postal|(room?,building?,street?,restante?,pobox?, 
  854.       city?,ponumber?,state?,postcode?,country?)" >
  855.  
  856. A physical address could be used for delivery of a physical
  857. object such as a letter or parcel, by a postal or courier
  858. service.  There are two ways in which a physical address can be
  859. encoded in SPCI.  One method or the other must be selected - they
  860. cannot be mixed.
  861.  
  862. The first way uses the postal element.  The contents of this is a
  863. list of address items, separated by the normal list separator <>.
  864. Each item in the list represents one line of address information
  865. which might appear on an envelope.  The order of items in the
  866. list is significant - the first item in the list appears at the
  867. top of the address, and the last appears at the bottom.  The last
  868. line will often (but not always) be the country name.
  869.  
  870. The second way of encoding a physical address uses individual
  871. elements for each component of the address.  Each element may
  872. occur zero or once, and the elements must be in the following
  873. order:
  874.  
  875. room      The room within a building for delivery.
  876.  
  877. building  The name of the building.
  878.  
  879. street    Street address (name and number).
  880.  
  881. restante  Post restante address.
  882.  
  883. pobox     Post office box number.
  884.  
  885. city      Town or city.
  886.  
  887. ponumber  Post Office number.
  888.  
  889.  
  890.  
  891.  
  892.  
  893. C.Adie             draft-adie-spci-00.txt                 17
  894.  
  895.  
  896. Internet Draft                12 October, 1993 (Expires April
  897. 1994)
  898.  
  899.  
  900.  
  901.  
  902. state     District, region, province or state.
  903.  
  904. postcode  Postal or ZIP code.
  905.  
  906. country   Country name (in full - ISO3166 abbreviations are not
  907.           normally acceptable except where they are in very
  908.           common use - eg "USA").
  909.  
  910. Following a physical address (in either form), there may be a
  911. courier element, specifying a preferred courier service for
  912. delivery to the address.
  913.  
  914. <!ELEMENT courier   - O  (carrier, account?, delivery?, phone?) >
  915.  
  916. The courier element may contain the following elements, in the
  917. order given below.
  918.  
  919. carrier   Name of the courier organisation.  Mandatory in a
  920.           courier element.
  921.  
  922. account   Account reference number.
  923.  
  924. delivery  Copied from PCI.  What is this for?
  925.  
  926. phone     Phone number of recipient (many courier companies
  927.           require this information).
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946. C.Adie             draft-adie-spci-00.txt                 18
  947.  
  948.  
  949. Internet Draft                12 October, 1993 (Expires April
  950. 1994)
  951.  
  952.  
  953.  
  954.  
  955.  
  956. 4. MIME Registration
  957.  
  958. The MIME registration for SPCI will be as follows:
  959.  
  960. MIME type name:     TEXT
  961.  
  962. MIME subtype name:  SPCI
  963.  
  964. Required parameters:     none
  965.  
  966. Optional parameters:     none
  967.  
  968. Encoding considerations: Some characters may not be sent directly
  969.                through some transport services.  Where possible,
  970.                it is recommended that quoted-printable encoding
  971.                be used, to preserve readability.
  972.  
  973. Security considerations: See separate section.
  974.  
  975. Published specification: A TEXT/SPCI body part will comprise
  976.                exactly one spci element as defined in this
  977.                specification.
  978.  
  979. Rationale:     Provides human-readable and machine-processable
  980.                method of encoding personal contact information.
  981.                This will permit automated processing, such as for
  982.                maintaining personal files of contact information.
  983.  
  984. Contact information:     See separate section.
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999. C.Adie             draft-adie-spci-00.txt                 19
  1000.  
  1001.  
  1002. Internet Draft                12 October, 1993 (Expires April
  1003. 1994)
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009. 5. References
  1010.  
  1011. [Adie 93] SGML-based Hierarchical Attribute/Value Encoding
  1012.           (SHAVE), C. Adie, September 1993.  Internet Draft (work
  1013.           in progress).
  1014.  
  1015. [Crocker 93a]  Structured Text Interchange Format (STIF), D.
  1016.           Crocker, June 1993.  Internet Draft (work in progress).
  1017.  
  1018. [Crocker 93b]  Encoding for Personal Contact Information (PCI),
  1019.           D. Crocker, June 1993.  Internet Draft (work in
  1020.           progress).
  1021.  
  1022.  
  1023. 6. Security Considerations
  1024.  
  1025. This document specifies a format for encoding personal contact
  1026. information.  It does not address issues relating to the accuracy
  1027. or authenticity of the information so encoded.
  1028.  
  1029. Individuals who supply contact information are invited to
  1030. consider whether the disclosure of such information (eg home
  1031. address) might lead to undesired consequences.
  1032.  
  1033.  
  1034. 7. Acknowlegements
  1035.  
  1036. SPCI was inspired by Dave Crocker's work on STIF [Crocker 93a]
  1037. and PCI [Crocker 93b], and the semantics of the SPCI elements are
  1038. based on those specifications.
  1039.  
  1040. If you provide constructive comments, you could find your name
  1041. appearing here.
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052. C.Adie             draft-adie-spci-00.txt                 20
  1053.  
  1054.  
  1055. Internet Draft                12 October, 1993 (Expires April
  1056. 1994)
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. 8. Contact
  1063.  
  1064. <spci>
  1065.  <person key="Chris Adie">
  1066.   <name>       Chris Adie
  1067.   <dept>       Computing Service
  1068.   <org>        Edinburgh University
  1069.   <email>      C.J.Adie@edinburgh.ac.uk
  1070.   <work>
  1071.    <phone>     +44 31 650 3363
  1072.    <fax>       +44 31 662 4809
  1073.    <building>  University Library Building
  1074.    <street>    George Square
  1075.    <city>      Edinburgh
  1076.    <postcode>  EH8 9LJ
  1077.    <country>   Great Britain
  1078. </spci>
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105. C.Adie             draft-adie-spci-00.txt                 21
  1106.  
  1107.  
  1108. Internet Draft                12 October, 1993 (Expires April
  1109. 1994)
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115. Appendix I - SPCI Document Type Definition
  1116.  
  1117. <!DOCTYPE spci [
  1118.  
  1119. <!-- Entity declarations -->
  1120. <!ENTITY amp     "&" >
  1121. <!ENTITY lt      "<" >
  1122. <!ENTITY % INHERIT  "#IMPLIED" >
  1123. <!ENTITY % aglobal  "cset CDATA %INHERIT;" >
  1124.  
  1125. <!-- This is used in the content models of elements which are lists. -
  1126. ->
  1127. <!ELEMENT item   O O (#PCDATA) >
  1128. <!ATTLIST item   %aglobal; >
  1129.  
  1130. <!-- The notation used for external references by this specification.
  1131. -->
  1132. <!NOTATION url   SYSTEM>
  1133.  
  1134. <!-- For experimental use. -->
  1135. <!ELEMENT X      - O RCDATA >
  1136. <!ATTLIST X
  1137.         %aglobal;
  1138.         type     CDATA     #REQUIRED
  1139. >
  1140.  
  1141. <!-- All SPCI data must be inside an spci element -->
  1142. <!ELEMENT spci   - - (person*) >
  1143. <!ATTLIST spci   %aglobal; >
  1144.  
  1145. <!-- Top-level element is a person -->
  1146. <!ELEMENT person - O (name? & email* & title? & org? & dept? &
  1147.                      motto? & note? & X.500? & work? & home? &
  1148.                      mobile? & support? & picture?) +(X) >
  1149. <!ATTLIST person
  1150.         %aglobal;
  1151.         -- for indexing purposes --
  1152.         key      CDATA     #REQUIRED
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158. C.Adie             draft-adie-spci-00.txt                 22
  1159.  
  1160.  
  1161. Internet Draft                12 October, 1993 (Expires April
  1162. 1994)
  1163.  
  1164.  
  1165.  
  1166.  
  1167. >
  1168.  
  1169. <!ELEMENT name   - O (#PCDATA) -- Personal name -->
  1170. <!ATTLIST name   %aglobal; >
  1171.  
  1172. <!ELEMENT org    - O (#PCDATA) -- Organisation -->
  1173. <!ATTLIST org    %aglobal; >
  1174.  
  1175. <!ELEMENT title  - O (#PCDATA) -- Role within org -->
  1176. <!ATTLIST title  %aglobal; >
  1177.  
  1178. <!ELEMENT dept   - O (#PCDATA) -- Department within org -->
  1179. <!ATTLIST dept   %aglobal; >
  1180.  
  1181. <!ELEMENT motto  - O (#PCDATA) -- Your text goes here -->
  1182. <!ATTLIST motto  %aglobal; >
  1183.  
  1184. <!ELEMENT X.500  - O (#PCDATA) -- Directory Name in UFN form -->
  1185. <!ATTLIST X.500  %aglobal; >
  1186.  
  1187. <!ELEMENT support- O (item+)   -- List of supported MIME types -->
  1188. <!ATTLIST support%aglobal; >
  1189.  
  1190. <!ELEMENT note   - O (#PCDATA) -- Info which doesn't fit elsewhere --
  1191. >
  1192. <!ATTLIST note   %aglobal; >
  1193.  
  1194. <!ELEMENT picture- O (#PCDATA) -- Photo of the individual -->
  1195. <!ATTLIST picture
  1196.         %aglobal;
  1197.         type     NOTATION  (url) url -- Content points to image --
  1198.         encoding CDATA     #REQUIRED -- MIME type/sybtype --
  1199. >
  1200.  
  1201. <!ELEMENT email  - O (#PCDATA) -- Electronic mail address -->
  1202. <!ATTLIST email
  1203.         %aglobal;
  1204.         mailsys  (X.400|RFC822) RFC822 -- any others? --
  1205.         mailtype (person|list|listownr) person
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211. C.Adie             draft-adie-spci-00.txt                 23
  1212.  
  1213.  
  1214. Internet Draft                12 October, 1993 (Expires April
  1215. 1994)
  1216.  
  1217.  
  1218.  
  1219.  
  1220. >
  1221.  
  1222. <!-- A physical address can either be an (unformatted) postal address,
  1223.      or a sequence of attributes. -->
  1224. <!ENTITY % physadr "postal|(room?,building?,street?,restante?,pobox?,
  1225. city?,ponumber?,state?,postcode?,country?)" >
  1226.  
  1227. <!-- These containers delimit contact info for different environments
  1228. -->
  1229. <!ELEMENT work   - O (phone? & fax? & ((%physadr;),courier?)? &
  1230. telex?) >
  1231. <!ATTLIST work   %aglobal; >
  1232.  
  1233. <!ELEMENT home   - O (phone? & fax? & ((%physadr;),courier?)? &
  1234. telex?) >
  1235. <!ATTLIST home   %aglobal; >
  1236.  
  1237. <!ELEMENT mobile - O (phone? & fax? & pager?) >
  1238. <!ATTLIST mobile %aglobal; >
  1239.  
  1240. <!ELEMENT phone  - O (item+)  -- may be more than one phone number --
  1241. >
  1242. <!ATTLIST phone  %aglobal; >
  1243.  
  1244. <!ELEMENT pager  - O (phone, instruct?) >
  1245. <!ATTLIST pager  %aglobal; >
  1246.  
  1247. <!ELEMENT telex  - O (#PCDATA) >
  1248. <!ATTLIST telex  %aglobal; >
  1249.  
  1250. <!-- Fax information is provided in several fax elements -->
  1251. <!ELEMENT fax    - O (faxno)+ >
  1252. <!ATTLIST fax    %aglobal; >
  1253.  
  1254. <!ELEMENT faxno  O O (#PCDATA,(grain? & instruct? & faxgate?)) >
  1255. <!ATTLIST faxno  %aglobal; >
  1256.  
  1257. <!ELEMENT instruct  - O
  1258.      (#PCDATA) >
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264. C.Adie             draft-adie-spci-00.txt                 24
  1265.  
  1266.  
  1267. Internet Draft                12 October, 1993 (Expires April
  1268. 1994)
  1269.  
  1270.  
  1271.  
  1272.  
  1273. <!ATTLIST instruct  %aglobal; >
  1274.  
  1275. <!ELEMENT grain  - O (#PCDATA) >
  1276. <!ATTLIST grain  %aglobal; >
  1277.  
  1278. <!ELEMENT faxgate- O (#PCDATA) >
  1279. <!ATTLIST faxgate%aglobal; >
  1280.  
  1281. <!-- A physical address as a (list of) undistinguished text items. -->
  1282. <!ELEMENT postal - O (item+) >
  1283. <!ATTLIST postal %aglobal; >
  1284.  
  1285. <!-- A physical address separated into its individual elements -->
  1286. <!ELEMENT room   - O (#PCDATA) -- Room within a building -->
  1287. <!ATTLIST room   %aglobal; >
  1288.  
  1289. <!ELEMENT building  - O
  1290.      (#PCDATA) -- Name of building -->
  1291. <!ATTLIST building  %aglobal; >
  1292.  
  1293. <!ELEMENT street - O (#PCDATA) -- Street address -->
  1294. <!ATTLIST street %aglobal; >
  1295.  
  1296. <!ELEMENT restante  - O
  1297.      (#PCDATA) -- Post restante address -->
  1298. <!ATTLIST restante  %aglobal; >
  1299.  
  1300. <!ELEMENT pobox  - O (#PCDATA) -- Post Office Box number -->
  1301. <!ATTLIST pobox  %aglobal; >
  1302.  
  1303. <!ELEMENT city   - O (#PCDATA) -- Town or city -->
  1304. <!ATTLIST city   %aglobal; >
  1305.  
  1306. <!ELEMENT ponumber  - O
  1307.      (#PCDATA) -- Post Office number -->
  1308. <!ATTLIST ponumber  %aglobal; >
  1309.  
  1310. <!ELEMENT state  - O (#PCDATA) -- District, region or state -->
  1311. <!ATTLIST state  %aglobal; >
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317. C.Adie             draft-adie-spci-00.txt                 25
  1318.  
  1319.  
  1320. Internet Draft                12 October, 1993 (Expires April
  1321. 1994)
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327. <!ELEMENT postcode  - O
  1328.      (#PCDATA) -- Postal or zip code -->
  1329. <!ATTLIST postcode  %aglobal; >
  1330.  
  1331. <!ELEMENT country- O (#PCDATA) -- Country -->
  1332. <!ATTLIST country%aglobal; >
  1333.  
  1334. <!-- Courier delivery information -->
  1335. <!ELEMENT courier- O (carrier, account?, delivery?, phone?) >
  1336. <!ATTLIST courier%aglobal; >
  1337.  
  1338. <!ELEMENT carrier- O (#PCDATA) >
  1339. <!ATTLIST carrier%aglobal; >
  1340.  
  1341. <!ELEMENT account- O (#PCDATA) >
  1342. <!ATTLIST account%aglobal; >
  1343.  
  1344. <!ELEMENT delivery  - O
  1345.      (#PCDATA) >
  1346. <!ATTLIST delivery  %aglobal; >
  1347.  
  1348. ]>
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370. C.Adie             draft-adie-spci-00.txt                 26
  1371.